From: Richard M. Stallman <rms@gnu.org>
Date: Thu, 24 Jun 2004 20:17:34 +0000 (+0000)
Subject: (Variable Definitions): Note about doc strings and :set.
X-Git-Tag: archive/raspbian/1%29.2+1-2+rpi1~1^2~21841
X-Git-Url: https://dgit.raspbian.org/%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:///%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:/?a=commitdiff_plain;h=e3d407cb7e15bc54206b373561e5902b8b7eeb24;p=emacs.git

(Variable Definitions): Note about doc strings and :set.
---

diff --git a/lispref/customize.texi b/lispref/customize.texi
index 5b95e911f85..c2e31462e0e 100644
--- a/lispref/customize.texi
+++ b/lispref/customize.texi
@@ -194,6 +194,11 @@ than one occasion.  You should normally avoid using backquotes in
 @var{default} because they are not expanded when editing the value,
 causing list values to appear to have the wrong structure.
 
+If you specify the @code{:set} option, to make the variable take other
+special actions when set through the customization buffer, the
+variable's documentation string should tell the user specifically how
+to do the same job in hand-written Lisp code.
+
 When you evaluate a @code{defcustom} form with @kbd{C-M-x} in Emacs Lisp
 mode (@code{eval-defun}), a special feature of @code{eval-defun}
 arranges to set the variable unconditionally, without testing whether